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Dear customer 


Congratulation 


in making a wise choice, Technology Research is 


confident that you will have many years of reliable service from 


the Interface. 


The Beta disk-interface has many advanced features which are 
summarised as follow: 


-- security: you can use the password facility to stop 


other copying your valuable programs, 


-- easy and fast access: you will be able to retrieve your 


data/program a lot faster than using cassette 
tape, 


-- Wide choice of disk drives: you are not restricted to a 


particular make of disk drives. You can use a 
40 track or 80 track, single or double sided 
disk drive, In short you can use most 
makes of disk drives in the market today 


-- Flexibility : you can increase the number of disk drives 


to a maximum of 3, 


This booklet contains all the information that you will need to 
make full use of the Beta Disk Interface, Technology Research 
wishes you to have many happy years with the Interface. 
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INSTALLATION PROCEDUPE 


that you have the Interface and a disk drive or a number of 
drives, please proceed according to the following steps. 


Connect the Interface to your Spectrum: please use the 
Diagram 1 on the inside cover of this booklet to identify 
the connectors on the Interface, and plug the Interface 
directly into your Spectrum (labelled A in diagram). 


Plug your disk drive into the "disk drive port"(labelled 5 
in diagram) in your Interface using the cable that comes 
with your disk drive, 


Switch on your disk drive and leave your Spectrum switched 
off, If the "drive on" indicator of your disk drive is on, 
then the disk drive socket is upside down. Turn the socket 
through 180 degree and try again, You will find that the 
drive on light should go out. 


Plug the power socket from your Spectrum rower supply into 
the power socket (labelled C in diagram) on your Interface. 
When you switch on, you will notice your disk drive engaged 
momentarily, This is normal, 


On your monitor (TV), you will see the current version of the 
software in your Interface and the name of Techology Pesearch 
at the top of the monitor, This means that your Interface 
is working. 


Insert the Technology Research Software Disk that comes with 
the Interface into your disk drive, 


You will have to put in a password in order to access the 
software stored on your disk. The nassvord that is used in 
all Software disks is " TRL", | You can always change it 
later if you wish. 

On the monitor (TV), you will find the symbol "A>", This 
prompt is issued by the Interface program and is a reminder 
that you are NOT in Sinclair BASIC, You are connected to 
disk drive A which is always the default disk drive. 





IMPORTANT 


NEVER disconnect the Interface fron the Snectrum whilst the rower 
is still applied. 


NEVER leave you disk in the disk drive while power is switched on 
or off. 


A SIMPLE GUIDE FOR THOSE WHO ARE NOT FAMILIAR WITH THE 
INTERFACE 





In this section, you will be introduced to various Disk 
Operating System ( D.0.S.) Commands through simple examples. 
They are probably something you are likely to do first 
time you come to use the Interface, The examples are 
arranged in an order a complete heginner is recommended to 
follow. 





EXAMPLE 1: SWITCHING FRO! Disk Operating System (0.0.8 ) 
TO SPECTRUM BASIC AND VICE VERSA, 
(How do I know when to Sinclair RASIC or 
Disk Operating System (D.0,8.)?) 








When you are in Sinclair BASIC, you do NOT get a prompt 
If you get the prompt " A>", then you are in D.0.S. 


To go from D,0.S, to Spectrum, press the following sequence 
of keys: 
RETURN ENTER 


To go from Spectrum to D.0.S., type in the following: 





RAMDONIZE USR 15360 
and you will get the D.0.S. prompt 


A? 


o 


4, 


EXAMPLE 2: PREPARING A NEW DISK (FORMATTING) 


(What do I have to do before I can use a brand new disk ?) 


Before you can use a disk, track markers have to be put onto 
the disk. All subsequent data that you put in will be 
stored into these marked tracks. 


If you only have one single disk drive, you will need to put 
in the Software disk into the disk drive first (assumming 
you have already switched the Snectrum and the disk drive 
on) and to have a new disk ready. 


Here is what you have to do: 


. Type in the line 


RUN "format"CODE 


(this command loads the program into the Spectrum. Now you 
will receive further prompts to advise you what to type in). 


IMPORTANT: If you have one SINGLE disk drive, then please 
take the Software disk out and put the new disk in. If you 
DO NOT do this, format your Software disk and all 
the information on it will be lest. 





+ You will need to tell the computer which disk drive you will 


be using. If you only have one disk drive, then logically 
you have to call it disk drive 





Then decide the vassword for the new disk and write it down 
somewhere you can refer to easily, 


IMPORTANT: If you lose the nassyord, then you will not be 
able to access the data again, 


Please tyne in the information when you are prompted, 
If the disk is good, then you will get no error, If the 
disk is faulty, then you will get an error prompt. In this 
case, you are advised to return the faulty disk to your 
dealer, 


Let us do one example. Suppose you have a disk drive which 
you call "A", you name the disk "SLUEPETER" and the 
password "PETER", Then you will see the folloving on the 
sereen, 


A>RUN "format"CODE 


* Mini-floppy Format Ver 2,2 * 
(c) 1984 Technology Research Ltd 


40 track sincle sided 
80 track single sided 
40 track double sided 
80 track double sided 
Quit 


Oeene 





Which format ? 


Assuming you are using a 40 track single sided disk 
drive,then you will select 1, The the screen will show: 


* 40 track single side * 
Which drive? (A,3,C,D, %enu) A (your input is 
required here) 


Please insert disk in drive A 
When you are ready, type FF for format 
Vv for verity 
Q for quit 

F 


Please type in a password: PETER 
Please type a name for this disk: PLUEPETER 


formatting track 00 
reading track 00 
formatting track 01 
reading track 01 


(and so on until it reaches track 39) 
0 Error(s) 
Which Drive? (A,8,C,D,Menu) 
If you wish to proceed to format more than one disk, then 


you type in the name of the disk drive and repeat the above 
procedure, 


EXAMPLE 3: CHANGE DISK PASSWORD 
(I don't like the Software disk password, how do 
I change it?) 


You have to imow the nassword before you can change it to 
another word of your preference, Let us assume that you have 
already typed in the required password and you are in 0.0.8, 
environment. To change the password to say JENNY, type: 

usR 
and type in the new password after you receive the promnt 


New password: "JENNY" 


The password of the disk is now JENNY. 


EXAMPLE 4: FILE TABLE 
(How do I find out what's on the disk and how much 
space I have got left?) 


To find out what is on the disk, you want a CATALOCUE of the 
items on the disk, The command for this is CAT, If you use 
this command on the Software disk, you will set the followinc: 


Title: Ultity 
3 File(s) 
0 Del, File(s) 


A: format (C) 10 : copy (B) 2 
A: copy (C) 14 


364 Free 


The first three lines indicate the title of the disk is 
called “Utility”, and there are 3 assessible files and there 
is no deleted file. 


The next line informs you that there are three programs 
called format(C),copy(B) and copy(C) in disk drive A, Take 
the format(C) as example the letter code C within the 


bracket means that it is a machine code program. In other 
words, the file type is CODE, For a BASIC program, the code 
is (8) and for a data file, the code is (D), The number 


following the file code is the length of the program. In 
this case, the length of the program is 10 sectors. 


The last line shows you that you have 364 sectors left on 
the disk. 


(NOTE: there are 4 sectors in 1K byte) 
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ERASE 


This comand will allow you to remove a file from the disk. 
You will have to snecify the file tyne as well if the file 
is not a PASIC program file, 


eg. 

ERASE "filename" for a hasic program file 

ERASE "filename"CODE for a machine coded progran file 
ERASE "filename"DATA for a data file 

LOAD 


This command will allow you to load a program from disk to 
your Spectrum, Please note that if there is insufficient 
memory in your Spectrum, you will get an error messare. 
*ERROR* 

When LOADing is complete and without error, you a.e 
automatically return to Spectrum PASIC and the program is 
listed, 

Example: 

LOAD "fileone" 


When loading Machine Code prozram, it can be relocated to a 
different address. 


Example: 
LOAD "filename" CODE 26000 


The Machine Code program is loaded into RAM starting from 
36000 
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c.4 


MERGE 


This comand is used to combine two or more BASIC program 
files. i.e. a number of programs can be merged to form a 
large program, 


Tor exanple: 


NERGE "OLD" to merge prozram OLD with the program 
in RAM 

IERGE "B:NEW" to merge program NEY in disk drive B 
with the program in RAN 





MOVE 


After a file has been deleted from disk, agap is left 
behind, As you continue to store programs onto the disk, 
eventually there will not be enough continuous storage space 
to store your program, ‘hen this happens, the retrieval and 
storage time for your program will increase. £0 to ensure 
this does not happen, you can use this command to repack the 
files on the disk in order to get rid of these "holes", 


Note: this command require 4K of memory for work space. If 
there is insufficient memory space, an error message will be 
displayed: 

*ERROR* 


Example: 


MOVE 


NEW 


Use this command when you wish to change the name of an 
existing file on disk. You will have to specify the file 
type if the file is not a basic program file. 


Example: 


NEW "newfile","oldfile" for BASIC program files, 

NEW "newfile","oldfile"CODE for machine code 
program files 

NEW "newfile","oldfile'DATA for a data file. 





1 


PEEK 


This comand 





allows you to read 
and transfer the data into RAM, 


any part of a file on disk 
You can only read a sector 


at a time and transfer the data to any location within the 

Buffer RAN, 

The command is in the form: | 
t 

PEEK "filename" Buffer address ,Record number 
For example: a 
i 

PEEK "RECORD" “30023,1 The first sector of the file 
"RECORD" is read and its content 
is written to RAM from the buffer 
address 30023, 

t 

PEEK "B:0LD" “30024,10 ‘The 10th sector of the file "OLD" 
on disk drive 3 is read and its 
content is written in RA! fron 
the buffer address 30024, 

POKE 


‘The command allows you to 
any 
form as PEEK, i.e. 


POKE "FILENAME" 
\s 


For exanple: 


POKE " 





RECORD" 30023, 1 


POKE "B:0LD" 30024,10 


RANDOMIZE USP. 15360 


Use this 
Spectrum BASIC, 


location in a file on disk, 


command when yourwish to return 


write a sector of data from RAM to 

‘The command takes similar 
ye 

it 

Buffer address ,Record Number 


A sector lencth of data starting 
from RAM address 30023 is written 


to the first sector of the file 
"RECORD", 
A sector length of data starting 


from RAM address 30024 is written 


to the 10th sector of the file 
“OLD" in disk drive 3. 
to D.O0,S. from 
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c.10 


c,11 


RUN 


This command will load a file from disk and run the prozran, 


You can either run BASIC programs or a machine code 


progran, 


For example: 


RUN "filel" for running a BASIC progam 
RUN "£ilel"CODE for running a machine code program 
Note: When running a BASIC program from disk, D.0,S. always 


starts from the first line of the BASIC program, i,e. GO TO 1 
instruction, 


SAVE 


This command will save a program in your Snectrum onto disk 
and the name of that program will be called "filename". You 
will also need to specify the file type if the prorram is 
not a BASIC program file. 


For a machine code program, there are three extra inputs: 
you will have to specify where the code is stored in the 
Spectrum by putting down the start address and length. The 
third parameter which is optional, is the address for 
autorun, 

The format is: 


SAVE "filename" CODE starting address,length ,autorun address 


For example: 


SAVE "filel" to save 


a basic vrogran 

SAVE "filel"CODE 10,200 to save a machine code program 
SAVE "filel"DATA a() to save a variable array a 
SAVE "filel"DATA a38() to save a character array aS 


SELECTION OF DISK DRIVE 


The default disk drive is set for disk drive A, The command 
to select other disk drives is as follows: 





an, for selecting disk drive B 
"Cc for selectingsdisk drive C 
"Dp for selecting disk drive D 
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c.12 


USR 


You can use this command to change the password of your 
disk, The password must not be longer than 9 characters 
(alpha-numeric). 


For example: 


USR 
New password: "BLUEPETER" 
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Commands 





ergy" 


eres" 


*" 





cAT 


ERASE 
LOAD 


MERGE 


MOVE 
NEW 
PEEK 


POKE 


RANDONIZE 
USR 15360 
RETURN 
RUN 

SAVE 


USR 


Poire 23339 yx 


X=<4g 


CUICK REFERENCE GUIDE TO D,O.S, 








to select disk drive A 


to select disk drive 2 
to select disk drive C 
to select disk drive D 
to display the file names 


to rub out (delete) a file 
e.c erase"filename" 


to load a program from disk to 
Spectrum 


to combine 2 or more PASIC prosrans 
to reorganise the location of 

files and pack them together 

to change the name of a file on 
disk 

e.g. new "newname","oldname” 

to random read from a file 

to random write to a file 


to co into D,0,S. environment 
from Snectrum PASIC 


to return to Sinclair PASIC from 
D0.8, 


to load and run a program 
e.f. run "name"CONE 


to save a program onto disk 
e.%. save "name" 


to change disk password 


smelled druio 
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USING D.O,S. COMMANDS IN RASIC PROGRAMS 


No doubt as your program skill develops, you will exploit 
the fast access time of the disk drive. You can do this fron 
within BASIC, All the 0.0.8, commands that are described 
above can be called up from within BASIC line with the 
following structure and the line can he anywhere within the 
BASIC program: 


line number RANDOMISE USR 15363: REN : 0D.0.S.comands 
For example: 
If you wish to run a program called "sketch" which is stored 


on disk from line 300 in your BASIC program, then all you 
have to do is to have the following line in your prosram: 


300 RANDOMISE USR 15363: REN : RUN "sketch" 
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HOW TO CONVERT PROGRAMS FROM CASSETTE TO DISK 


Loading from cassette to disk. 
You can achieve this in your BASIC program by using the line: 


PANDOMISE USR 15363: RE 





AD "filename" 
For example: 
IZ the LOAD command in your cassette version is: 

200 LOAD "filename" 


Then it can be replaced b: 





200 RANDOMISE USR 15363: 





: LOAD "filename" 


Saving from cassette to disk. 


The process is similar to the LOADING process described 
in F.1. 


For example: 

If the SAVE command in your cassette version is 
200 SAVE "filename" 

Then it can be replaced by 


200 RANDOMISE USR 15363: REM : SAVE "filenae” 
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. TO CALL DOS COMMANDS FROM MACHINE CODE PROGRAM, 


When calling DOS commands from BASIC program, e.f. 
RANDS USR 15363: REM : LOAD "examnle” 


To run above cammand in “achine code, all you have to do, 
is to "fool" the system by alterinr the BASIC variable CH. 
ADD to point to an address line buffer, created by your 
machine code program, 








For example: 


If you use a buffer address 40000, then the above cammand 
will be set to 





address code comment 

40000 234 BASIC REM code 
40001 58 3 

40002 239 LOAD BASIC LOAD code 
40003 34 NY 

40004 101 e 

40005 120 x 

40006 97 a 

40007 109 n file name "example" 
40008 112 Dp 

40009 108 1 

40010 101 e 

40011 34 y 

40012 13 ENTER always end with 





Once the above line is finalized you can call the following 


example. 
LD HL, (CHADD) WHERE CHADD IS 23645 
LD (TEMP), EL SAVE IT IN SOME PLACE 
LD (CHADD) ,40000 SET CH ADD TO 40000 
CALL 15363 CALL TR-DOS AS FROM PASIC 


LD HL, (TEMP) 
LD (CHADD) , i RESTORE CHADD CONTENTS 
RET 
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H, UTILITY PROGRAMS 


Kyl 


BACKUP 

It is necessary ,in many cases, that your files need to he 
duplicated to another disk for security reason. This procram 
allows you to duplicate all the files (including the disk 
password) in a disk to another disk for a SINGLE drive user, 
You will need a (newly) formatted disk with no files on it . 
Any files on this disk will be overwritten when this vrogran 
is executed, 


Assuming that the password is BLUEPETER on the disk where 
there are a number of files 


To execute this program, type 
RUN "backun" 
You will get the following display: 


* BACKUP 2,2 * 
©1984 TECHNOLOGY 





ARCH LTD 


PASSWORD TOR SOURCE DISK: 
BLUEPETER 

INSERT SOURCE DISK THEN PRESS Y. 
Y 


INSERT DESTINATION DISK 
THEN PRESS Y 


¥ 


Because of the RAM capacity of the Spectrum, only 
approximately 24 Kbytes of data can be duplicated at one 
time. That is to say, for a disk with more than 24 Kbytes of 
data to be duplicated, it will require several operations of 
the above process. 


NOTE: If you wish to abandon the program before it 1s 
executed, press EDIT key. 
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H.2 COPY 


This facility allows you to duplicate programs/data from one 
disk drive(source) to another disk drive(destination). 
While you are using this program you can also execute other 
D.O.S, commands (see below) which are described in Section 
Gs 


To execute this program, type 
RUN "copy" 
The display on screen will be 
* COPY VER 2.2 * 
©1984 TECHNOLOGY RESEARCH LTD, 
COMMANDS ARE: 
CAT 
NEW "newfile", ‘oldfile" 
ERASE "filename" 
MOVE 
COPY “newfile", "oldfile" 
RETURN 


A® 


You will notice that A* is issued rather than A> It is to 
remind you that you are in COPY MODE, 


Example 1 
Ig you are copying a file called "Jenny" from dist drive 
A(source) to disk drive B(destination) and you vould like to 
give a new file name " Jacky" to it, then type 

A* COPY "B: Jacky", "A:Jenny"™ 
Example 2 
Ig you are copying all the files from disk drive A 
(source)to disk drive B(destination), then type 

A* COPY "Bra", "ADH 


If there is a file with the same name exist on disk RB 
already, you will have the folloving options, 


OVERWRITE EXISTING FILE (¥/N) 
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FORMAT 


As described in 3,2, this Utility promram allows you to 
format a new disk and to check for any disk errors, (i.e.bad 
disk) 
To execute this program, type 

RUN "format"CODE 
There are 3 options: 


F for format 


Ig you like to see a working example, turn to section B 
example B.2 


V for verify 


This option will check for disk error (i.e. bad disk ) 
without destroying the data that you have on the disk. 


Q for quit 


When you have finished formatting or verifying your disk, 
you can use this option to leave the FORMAT environnent, 
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H.4 SCOPY 


This program allows you to cony a single file from one disk 
to another disk for a SINGLE disk drive user, While vou are 
using this program you can also execute other 0.0.8. 
commands (see below) which are described in Section C, 
To excecute the program, type 
RUN "scopy" 
The display on screen will be: 
*SCOPY VER 2.2 * 
© 1984 TECHNOLOGY RESEARCH LTD, 


COMMANDS ARE: 


CAT 

NEY "newfile", "“oldfile" 
ERASE "filename" 

MOVE 

COPY "newfile" 

RETURN 


Att 


You will notice that A is issued instead of A>. It is to 
remind you that you are in SCOPY MONE, 


Example: 
If you are copying a file "format", then type 


COPY "format"CODE 

The display will be: 
INSERT SOURCE DISK THEN PRESS ¥ 
y 


INSERT DESTINATION DISK 
THEN PRESS Y 


y 
When the above process is completed, it will return to 


Ay 
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I, ERROR MESSAGES 


If D.0.8, commands are from BASIC or Machine Code programs, 
then D.9.S, error messares will not be issued on the screen, 
Instead,they are stored in the 780 Register Pair (3C) and 
they are in code, The key to dicipher the code is: 


---- No errors 

No files 

File exit 

No space 

Record number overflow 
Disk errors 

Syntax errors 





e@rnwnHo 





To obtain the error code, set a variable equal to the D..S. 
commands, The variable will take on the value of the error 
code on the completion of the D.0.S, command, 


Example 1: 


LET A = USR 15363 REM:CAT 





Example 2: 
A simple program illustrating the use of this error code 


10 CLEAR 65367 

20 LET ERR=USR 15363: REM : LOAD "COPY"CODE 

25 REM ERROR CODE IS RETURN IN THE VARIABLE ERR 

30 IF ERR = 1 THEN GO TO 100 

35 REM IF ERROR CODE = 1 THEN THE FILE CODE IS NOT ON 

THE DISK 

40 RANDOMIZE US? 32768 

50 PANCOMIZE USR 15360 
100 CLS 
110 PRINT AT 10,1; 
120 STOP 





'COPY"" CODE NOT ON DISK" 
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J, PIN CONNECTIONS OF THE THE DISK DRIVF CONNECTOR . 


The 
Shugart compatible, 
below: 


Car 


Diagran 


disk drive connector (see Diagram 2) is 


and the pin connections 
















disiqned to be 
are detailed as 


ov 

ov 

ov Disk drive D 

ov Index 

ov Disk drive A 

ov Disk drive B 
ov 14--Disk drive C 

ov 16--Head Load( Motor on) 
ov 

ov 

ov Data 

ov Gate 

ov oo 

ov Protected 





ov 
oy 
ov 


( SKETCH OF FRONT VIEW ) 
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PIN CONNECTIONS OF THE THE DISK DRIVE CONNECTOR . 


